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User  communities 

OneSAF  is  chartered  to  serve  three  communities,  each  of  which  has 
its  own  requirements  and  priorities: 

•  Advanced  Concepts  and  Requirements  (ACR) 

•  Research,  Development  and  Acquisition  (RDA) 

•  Training,  Exercise  and  Military  Operations  (TEMO) 


In  addition  to  these,  PM  OneSAF  also  directs  support  that  is  to 
be  provided  to  various  joint  and  civilian  organizations,  and 
international  customers. 
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The  Simulation  Lifecycle 


*  The  lifecycle  phases 
do  not  intend  to  restrict 
the  use  of  common 
tools  across  many 
phases.  Users  can 
transcend  phases. 


1-3, 15:  Product  Line 

Development,  Deployment 
&.  Maintenance  phases 

4-8: 

Pre-Event  phases 

9-11 

Event  phases 

12-14: 

Post-Event  phases 

*  Iteration 
back  and  forth 
between  phases 
not  shown 
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Composable  Product  Line  Concept 

•  OneSAF  is  not  a  single  system  or  product. 

•  OneSAF  is  a  set  of: 

-  Components, 

-  Products  comprising  OneSAF  components, 

-  System  compositions  comprising  OneSAF  products 

•  Tools  are  provided  to  create  compositions  of  various 
types  (including  system  compositions). 
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The  Product  Line  Architecture  Framework 
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Military  Scenario  Definition  Environment  (MSDE) 

-  PowerPoint-based 

-  Creates  scenario  definition  (units,  command 
relationships,  dispositions)  in  Military  Scenario 
Definition  Language  (MSDL) 

-  MSDL  is  imported  into  a  OneSAF  scenario  for 
execution 

After-action  Review  (AAR)  Tool 

-  Generates  slides  of  the  simulated  scenario 

-  Statistics  of  “snapshot”  data  items 
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Composability 


Composability: 

-  The  ability  to  assemble  reusable  software  elements 
(“components”)  into  customized  software. 

-  A  central  design  theme  of  OneSAF. 

Fairly  recent  capability  in  software  development  enabled  by: 

-  increased  computing  power, 

-  success  in  developing  reusable  software  libraries,  and 

-  the  development  and  distribution  of  software  and  software 
components  over  the  internet  to  different  computer  systems. 


Instead  of  developing  complete  computer  programs  for  each 
computer  system,  software  developers  develop  platform 
independent  components  to  be  assembled  on  the  user’s  computer. 
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Composition  nomenclature 

Use  of  the  term  ’’composition"  is  ubiquitous  in  OneSAF,  and  usually 
requires  context  to  know  exactly  what  is  being  described: 

-  System  composition :  a  JAR  file  consisting  of  a  set  of  system 
components 

-  Component  composition’,  an  XML  file  containing  pointers  to 
various  Java  classes;  used  to  imbue  actors  with  capabilities  such 
as: 

•  Vulnerability,  mobility,  and  sensing  (physical  components) 

•  Responsiveness  to  orders,  ability  to  process  fire  missions  (behavioral 
components) 

-  Actor  compositions: 

•  Entity  composition :  an  XML  file  containing  metadata  and  pointers  to 
component  compositions  defining  a  single,  indivisible  battlespace  object 

•  Unit  composition :  an  XML  file  containing  metadata  and  pointers  to 
component  compositions  defining  a  single,  indivisible  battlespace  object 

-  Behavior  composition :  an  XML  file  containing  metadata,  inputs, 
(in  the  case  of  composite  behaviors)  outputs,  and  control 
definitions  defining  the  effect  of  a  behavior 
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OneSAF  System  Components 

•  A  OneSAF  system  composition  is  an  assembly  of  system  components.  In 
some  ways  a  system  composition  is  analogous  to  an  executable  program. 

•  A  system  component  is  a  modular  software  artifact  that  makes  specific 
functionality  available  to  the  system  composition. 

•  Some  examples: 

-  The  Formation  Editor  is  a  system  component  providing  a  graphical 
tool  that  may  be  used  to  interactively  design  formation  data  files. 

-  The  formationEditor  system  composition  consists  of  the  Formation 
Editor  and  the  Desktop  components. 

•  OneSAF  components  are  JavaBeans  with  extensions;  e.g.: 

-  OneSAF  specific  component  metadata  such  as  releasability, 
dependencies,  and  fidelity 

-  Non- Java  code  support  to  allow  reuse  of  code  written  in  other 
languages. 

•  Components  can  contain  any  subset  of: 

-  Data 

-  Software  source  code 

-  Software  executable  code 

-  Documentation 


1 
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System  Composer 

The  System  Composer  is  a  graphical  tool  used  to  create  OneSAF  system 
compositions: 

-  The  System  Composer  is  based  on  JavaBean  application  builders  but 
works  with  OneSAF  extended  JavaBeans  (OneSAF  system 
components). 

-  The  System  Composer  creates  a  JAR  file  for  each  composition  (the 
composition  and  JAR  file  have  the  same  name)  containing: 

-  Information  the  runtimeloader  script  uses  to  run  the  composition. 

-  Composition  metadata;  e.g., 

•  Description 

•  Specification  and  Implementation  Version 

•  Validation  Authority  and  Date 

-  The  System  Composer  provides  the  software  “glue”  connecting 
components. 

It  is  executed  from  the  command  prompt  by  running  the  composer  script 
within  S WR/bin/ services/ sy s/ composition 

-  This  is  the  only  stand-alone  application  within  OneSAF;  all  other 
applications  are  started  using  the  runtimeloader  script  in  the  same 
directory 
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System  Composer 
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Entity  Composer 
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Using  the  Entity  Composer 


System  composition  =  composers,  therefore 
$BINDIR/ runtimeloader  composers 

Typical  components 

-  Physical 

•  Sensors  (eyeballs,  FLIR,  etc.) 

•  Weapons 

•  Mobility 

•  Vulnerability 

-  Behavior 

•  Direct  fire  controller 

•  Operations 

•  Intel 

•  Supply 
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Unit  Composer 
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Behavior  Composer 
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The  Management  and  Control  Tool 
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Sides  and  Forces 


•  A  force  is  a  collection  of  entities,  units,  or  forces. 

•  A  side  is  a  collection  of  entities,  units,  forces,  or  sides. 

•  Sides  have  relationships  which  determine  certain 
behaviors. 
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Variable  fidelity 

•  Support  for  variable  levels  of  fidelity  makes  it  possible  to  tailor  the 
simulation  in  order  to  maximize  satisfaction  of  diverse  use  cases. 

•  Accurately  and  effectively  represents  activities  within  the  Army 
warfighting  functions: 

•  Intelligence 

•  Movement  and  maneuver 

•  Fire  support 

•  Protection 

•  Sustainment 

•  Command  and  control 
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Distributed  Simulation 


OneSAF  is  a  distributed  simulation  system. 

Workstations  may  be  assigned  different  computational 
roles,  such  as: 

-  Simulation  core  (SimCore) 

-  Management  and  Control  Tool  interface 

-  C4I  adapter 
Distributed  design  allows: 

-  Individual  workstations  to  balance  loads 

-  System  recovery  of  individual  workstations  without 
interrupting  a  simulation  in  progress 
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Interoperability 


•  OneSAF  instances  interoperate  via: 

-  Internal  protocols 

•  OneSAF  messaging  services 

•  C4I  Adapter 

-  External  protocols 

•  HLA 

•  DIS 
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Overview  Summary 

OneSAF  is  a  highly  configurable  suite  of  systems  for  the 
generation  of  semi-autonomous  forces. 


Simulation  behaviors  and  models  are  data  driven  to  the 
maximum  extent  possible,  to  support  customization  and 
“what-if  ’  analysis 

System  capabilities  are  exposed  by  powerful  visual  tools. 

High  degree  of  interoperability  through  DIS  and  HLA, 
and  usage  of  common  formats  including  XML  for  state. 
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The  OneSAF  Agent  Architecture 
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Battlespace  participants  (actors) 
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Battlespace  participants  (actors) 


Actor: 

-  An  entity  or  unit 

-  A  simulated  thing  that  can  be  instantiated  in  a  battlespace  and 
has  a  location 

Entity: 

-  The  smallest  discrete,  stand-alone  actor. 

-  Implemented  as  a  composition  of  physical  components  and 
behavioral  components. 

Unit: 

-  An  organized  collection  of  actors  and  their  capabilities. 

-  Alternatively  ...  “a  collection  of  actors” 

-  A  simulation  object  representing  the  combined  command  and 
control  of  a  collection  of  subordinate  actors  (entities  and  sub¬ 
units). 

-  Alternatively  ...  “a  collection  of  components” 
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Components 


Discovered  method  invocation 
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Components 


Agents: 

-  Behavioral  agents  provide  command  and  control 
capabilities,  such  as  planning,  plan  execution,  and 
situation  assessment. 

-  Physical  agents  are  the  “middlemen”  between 
behaviors,  the  physical  world,  and  physical  models. 

Models: 

-  Behavioral  models  answer  behavior  agents’  questions 
and  represent  the  reasoning  of  agents. 

-  Physical  models  provide  physical  capabilities,  such 
as  mobility,  weapons,  vulnerability,  sensing,  and 
communications.  They  represent  the  effectors  and 
perceptors  of  simulated  platforms  and  the  physics  of 
the  simulated  world. 
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Example  Agents 


•  Behavioral  Agents: 

-  Command 

-  Scheduler 

-  Intel 

-  Message 

-  Operations 

-  Driver 

-  Direct  Fire  Weapons 
Controller 

-  Fire  Direction  Center 

-  Caller  For  Fire 

-  ADA  Target  Handoff 


•  Physical  Agents: 

-  Weapon 

-  Radio 

-  Sensor 

-  Mobility 

-  Transport 

-  Vulnerability 
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Behaviors 


Composite  behaviors 


•  Composite  Behaviors: 

-  Represent  tasks  and  missions 

-  Are  composed  of  primitive  and  other  composite 
behaviors 

-  Are  created  with  the  Behavior  Composer. 

•  Temporal  organization: 

-  Sequential 

-  Parallel 

•  Conditional  Branching 

•  Looping 
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Primitive  behaviors 


•  Primitive  behaviors: 

-  Provide  chunks  of  functionality  from  which  more 
complex  behavior  models  are  built. 

-  Are  parameterized  with  inputs,  and  may  have 
outputs 

-  Interact  with  behavioral  agents. 

•  Are  implemented  as  Java  classes,  with  an  XML 
wrapper  to  allow  composition 
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State  transitions 
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Content  carriers 


•  Event 

-  Information  object  that  is  sent  from  an  actor  to  the  external  world  over  the  network. 

-  Events  are  “sent”  on  the  EventRouter. 

-  Also  referred  to  as  a  “Simulation  Event.” 

•  Trigger 

-  Information  object  sent  internal  to  an  actor.  May  be  sent/received  by  agents  and 
behaviors. 

-  Triggers  are  “posted”  on  the  blackboard. 

-  Also  referred  to  as  a  “Command.” 

•  Directive 

-  A  special  event  that  can  also  function  as  a  trigger. 

-  The  Directive  may  be  “sent”  or  “posted.”  When  it  is  received  as  an  event,  it  will 
automatically  be  posted  as  a  trigger  on  the  blackboard. 

-  Also  referred  to  as  an  “Intervention”  (on  the  MCT). 

•  Fact 

-  Information  object  that  is  stored  in  the  blackboard. 

-  Facts  may  be  simple  “Information  Facts”  that  store  information  or  they  may  be  “Fuzzy 
Facts”  that  can  evaluate  its  stored  information  and  modify  it  over  time. 

•  Message 

-  A  class  of  events  used  by  the  communication  framework. 
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The  Blackboard 


•  The  Blackboard  is  an  Agent  control  mechanism: 

-  Agents  subscribe  to  triggers  on  the  blackboard. 

-  When  the  blackboard  receives  a  trigger,  the  it  notifies 
that  trigger’s  subscribers  (and  only  those  subscribers). 

•  Blackboard: 

-  “World  Model”  for  an  actor  containing  perceived  truth. 

»  Send  and  receive  (internal)  triggers 
»  Contains  facts 
»  Access  physical  capabilities 

-  One  instance  per  actor;  cannot  be  shared  with  other 
actors. 
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OneSAF  processes 
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Capability  Development 
Process  Flow 
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What  problem  does  Conceptual  Modeling 


address? 


Simulating  the  real  world  is  difficult  and  error  prone . 

A  well-conceived,  consistent  intermediate  model  eliminates  many 
problems  by  providing  a  model  of  the  battlespace  usable  by  all 
participants  (customer,  domain  expert,  developer,  and  user). 
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Conceptual  Modeling  and 
Knowledge  Engineering  Process 

Main  products: 

o  Capability  Description  Document  (CDD) 
o  Domain  Behavior  Description  (DBD) 
o  Physical  Knowledge  Acquisition  Document  (PKAD) 
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Implementation  Build 
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Co-developer  handover  process 
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General  handover  criteria 


•  Integration  with  OneSAF :  It  is  expected  that  handovers  are 
submitted  for  the  purpose  of  integration  into  OneSAF,  and  that 
they  are  ready  for  integration. 

•  Development  baseline :  Capabilities  must  be  developed  against  the 
most  recent  generally  available  release. 

•  Architectural  compliance :  Handover  products  must  comply  with 
architectural  and  design  guidelines,  protocols,  language 
compatibilities,  code  structures,  and  documentation  standards. 

•  Testing :  Capabilities  must  be  tested  during  development  to  ensure 
that  they  operate  as  designed  are  not  injurious  OneSAF. 

•  Classification :  At  present,  all  handover  products  must  be 
unclassified. 
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Co-developer  handover  process 

To  be  considered  for  inclusion  with  a  baseline  release,  co¬ 
developers  participate  in  several  activities: 

-  Registration  (co-developer) 

-  Initial  review  (OneSAF  Architecture  and  Integration) 

-  Handover  package  submission  (co-developer) 

-  Engineering  Change  Control  Board  review 

-  Peer  review  (OneSAF  Architecture  and  Integration) 

-  Baseline  integration  and  test  (OneSAF  Architecture  and 
Integration,  with  co-developer  participation  desired) 

Required  artifacts: 

-  Source  code  and  data 

-  Design  documentation  (use  cases,  sequence  and  class 
diagrams) 

-  Domain  documentation  (PKAD  /  DBD  /  CDD) 

-  Usage  instructions 

-  Unit  tests  and  system  test  cases 

-  Architectural  compliance  assessment  ^ 
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Questions? 
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